Appendix A 

Example Site Manager Control Messages for a Pumpstation 



The following is a general hello message used by a pumpstation site manager to "ping" 
other sites in order to determine their current availability. 
Request: FTXHELLO [ | mid= {message id} ] 

Response: FTXSUCCESS | name= {site name} | type= {site type} [ | rid= {message id} ] 

Where: {site name} = text description of this site (e.g. "My Test Site Manager") 

{site type} = text identifying type of site (e.g. "FTX Site Manager") 
{message id} = [optional] message identification tag 

The following is the message may be used to register a site with a site manager. If a 
matching site (same name^ & type=) is not found, the site is added (further entry modifications 
for this site may require matching security info). If the site is found and the provided security 
information matches, the old entry will be replaced with the new information. 

Request: FTXREGSITE | name= {site name} | type= {site type} | 

addr= {listen address} | port= {listen port} | 
sec= {security info} [ | mid= {message id} ] 

Response: FTXSUCCESS [ | rid= {message id} ] 

FTXF AILED | comment= {failure reason} [ | rid= {message id} ] 



Where: 



{site name} = text description of this site (e.g. "My Test Site Manager") 
{site type} = text identifying type of site (e.g. "FTX Site Manager") 
{listen address} = TCP/IP address that the site is listening for messages on 
{listen port} = TCP/IP port that the site is listening for messages on 
{security info} = one of the following formats, 

user= {user name} | pwd= {user password} 

sec= {CRC-32 of {user name} + {user password} } 
{message id} = [optional] message identification tag 
{failure reason} = one of, 

"Site Manager cannot handle any more connections" 

"Request does not contain all required tags ('name- , 'addr- , and 'port=')" 

"Not Authorized for the Message Type" 
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The following is the message may be used to unregister a site with a site manager. If a 
matching site is found (same name= & type=) and the provided security info matches, the entry 
is removed. 

Request; FTXUNREGSITE | name= {site name} | type= {site type} | 

sec= {security info} [ | mid= {message id} ] 

Response: FTXSUCCESS [ | rid= {message id} ] 

FTXF AILED | comment= {failure reason} [ | rid= {message id} ] 

Where: {site name} = text description of this site (e.g. "My Test Site Manager") 

{site type} = text identifying type of site (e.g. "FTX Site Manager") 
{security info} = one of the following formats, 

user= {user name} | pwd= {user password} 

sec- {CRC-32 of {user name} + {user password} } 
{message id} = [optional] message identification tag 
{failure reason} = one of, 

"Request does not contain all required tags ('name- , 'addr=', and 'port^)" 

"Not Authorized for the Message Type" 

The following is the message may be used to request a list of all available registered sites' 
information. Sites that provide qualifying security information may be returned in the list. 

Request: FTXLISTREGSITE | sec= {security info} [ | mid= {message id} ] 

Response: FTXSUCCESS {site information} [ | rid= {message id} ] 

FTXF AILED | comment= {failure reason} [ | rid= {message id} ] 



Where: 



{site information} = one or more lines of the following format, 

name- {site name} | type= {site type} | addr= {listen address} | port= {listen port} 
{site name} = text description of the site (e.g. "My Test Site Manager") 
{site type} = text identifying type of site (e.g. "FTX Site Manager") 
{listen address} = TCP/IP address that the site is listening for messages on 
{listen port} = TCP/IP port that the site is listening for messages on 

{security info} = one of the following formats, 

user= {user name} | pwd= {user password} 

sec= {CRC-32 of {user name} + {user password}} 

{message id} = [optional] message identification tag 

{failure reason} = one of, 

"Request does not contain all required tags ('name- , 'addr=', and 'port^')" 
"Not Authorized for the Message Type" 
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The following message may be used to request (by name and type) the address of a 
specific site. If the provided security information qualifies, the sites' address info is returned. 
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Request: FTXGETSITE | name- {site name} | type= {site type} | 

sec= {security info} [ | mid= {message id} ] 

Response: FTXSUCCESS | name= {site name} | type= {site type} | 

addr= {listen address} | port= {listen port} [ | rid= {message id} ] 

FTXF AILED | comment- {failure reason} [ | rid= {message id} ] 

Where: {site name} = text description of the site (e.g. "My Test Site Manager") 

{site type} = text identifying type of site (e.g. "FTX Site Manager") 
{listen address} = TCP/IP address that the site is listening for messages on 
{listen port} - TCP/IP port that the site is listening for messages on 
{security info} = one of the following formats, 

user= {user name} | pwd= {user password} 

sec= {CRC-32 of {user name} + {user password} } 
{message id} = [optional] message identification tag 
{failure reason} = one of, 

"Request does not contain all required tags ('name- , 'addr=', and 'port=')" 

"Not Authorized for the Message Type" 
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